Foxit PDF SDK
FoxitPDFSDKPython3.TaggedPDF Class Reference
Inheritance diagram for FoxitPDFSDKPython3.TaggedPDF:
FoxitPDFSDKPython3.Base

Public Member Functions

def TaggedPDF (doc, is_fix)
 Constructor.
More...
 
def TaggedPDF (other)
 Constructor, with another tagged PDF object.
More...
 
def CanTagDocument ()
 Check whether the current PDF document can be tagged.
More...
 
def CanTagFormFields ()
 Check whether the form fields in the current PDF document can be auto tagged.
More...
 
def GetCurrentFigureElementIndex ()
 Get current figure element index.
More...
 
def GetFigureAlternateText (figure_index)
 Get the alternate text of the figure.
More...
 
def GetFigureCount ()
 Get the count of figures in tagged document, excluding the decorative figures.
More...
 
def GetFigurePageIndex (figure_index)
 Get the figure page index by the figure index.
More...
 
def GetFigureRect (figure_index)
 Get the rectangle of figure.
More...
 
def GetNextFigureData ()
 Get next figure data.
More...
 
def GetPrevFigureData ()
 Get previous figure data.
More...
 
def HasFigures ()
 Check whether the document has figures.
More...
 
def IsAlreadyTagged ()
 Check whether the current PDF document is already tagged.
More...
 
def IsEmpty ()
 Check whether current object is empty or not.
More...
 
def RemoveTags ()
 Remove the accessibility tag tree tree for the current PDF document.
More...
 
def SaveFigureData ()
 Save figure data.
More...
 
def SetAsDecorativeFigure (figure_index)
 Decorate the figure.The decorative figure can not set alternate text.
More...
 
def SetCallback (callback)
 
def SetCurrentFigureDataInfo (is_decorative, alternate_text)
 Set current figure data info.
More...
 
def SetFigureAlternateText (figure_index, alternate_text)
 Set figure alternate text.
More...
 
def StartTagDocument (pause, report_callback, callback)
 Start to auto tag the given PDF document with specified tagged settings.
More...
 
def TagFormFields ()
 Tag form fields in the current PDF document.
More...
 

Detailed Description

This class represents settings for a tagged PDF document.The tagged PDF means that only tagging information for PDF structure here. Before using any class or methods in this module, please ensure Foxit PDF SDK has been initialized successfully by function FoxitPDFSDKPython3.Library.Initialize with a key including "Accessibility" module.

See also
FoxitPDFSDKPython3.Library

Constructor & Destructor Documentation

◆ TaggedPDF() [1/2]

def FoxitPDFSDKPython3.TaggedPDF.TaggedPDF (   doc,
  is_fix 
)

Constructor.

Parameters
[in]docA valid PDF document object to be tagged.
[in]is_fixWhether this tagged PDF is used for fix operation. If true, figure data methods will use fix alternate text; if false, they will use no-fix alternate text. Default value: false.

This constructor is to construct a tagged PDF object with specified settings.

◆ TaggedPDF() [2/2]

def FoxitPDFSDKPython3.TaggedPDF.TaggedPDF (   other)

Constructor, with another tagged PDF object.

Parameters
[in]otherAnother tagged PDF object.

Member Function Documentation

◆ CanTagDocument()

def FoxitPDFSDKPython3.TaggedPDF.CanTagDocument ( )

Check whether the current PDF document can be tagged.

Returns
true means the document can be tagged, while false means not.

◆ CanTagFormFields()

def FoxitPDFSDKPython3.TaggedPDF.CanTagFormFields ( )

Check whether the form fields in the current PDF document can be auto tagged.

The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Returns
true means form fields can be auto tagged, while false means not.

◆ GetCurrentFigureElementIndex()

def FoxitPDFSDKPython3.TaggedPDF.GetCurrentFigureElementIndex ( )

Get current figure element index.

Returns
The current figure element index.

◆ GetFigureAlternateText()

def FoxitPDFSDKPython3.TaggedPDF.GetFigureAlternateText (   figure_index)

Get the alternate text of the figure.

The alternate text is the human-readable text, the PDF documents can be enhanced by providing alternate text for images, formulas, or other items that do not translate naturally into text. The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Parameters
[in]figure_indexThe index of figure. Valid range: from 0 to (count-1). count is returned by function FoxitPDFSDKPython3.TaggedPDF.GetFigureCount .
Returns
The alternative descriptions text.

◆ GetFigureCount()

def FoxitPDFSDKPython3.TaggedPDF.GetFigureCount ( )

Get the count of figures in tagged document, excluding the decorative figures.

The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Returns
The count of figures.

◆ GetFigurePageIndex()

def FoxitPDFSDKPython3.TaggedPDF.GetFigurePageIndex (   figure_index)

Get the figure page index by the figure index.

The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Parameters
[in]figure_indexThe index of figure. Valid range: from 0 to (count-1). count is returned by function FoxitPDFSDKPython3.TaggedPDF.GetFigureCount .
Returns
The page index. Valid value would starts from 0. If there is any error, this function will return -1.

◆ GetFigureRect()

def FoxitPDFSDKPython3.TaggedPDF.GetFigureRect (   figure_index)

Get the rectangle of figure.

The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Parameters
[in]figure_indexThe index of figure. Valid range: from 0 to (count-1). count is returned by function FoxitPDFSDKPython3.TaggedPDF.GetFigureCount .
Returns
The figure rectangle.If there is any error, this function will return an empty rectangle.

◆ GetNextFigureData()

def FoxitPDFSDKPython3.TaggedPDF.GetNextFigureData ( )

Get next figure data.

Returns
The next figure data object.

◆ GetPrevFigureData()

def FoxitPDFSDKPython3.TaggedPDF.GetPrevFigureData ( )

Get previous figure data.

Returns
The previous figure data object.

◆ HasFigures()

def FoxitPDFSDKPython3.TaggedPDF.HasFigures ( )

Check whether the document has figures.

Returns
true means the document has figures, while false means not.

◆ IsAlreadyTagged()

def FoxitPDFSDKPython3.TaggedPDF.IsAlreadyTagged ( )

Check whether the current PDF document is already tagged.

Returns
true means the document is already tagged, while false means not.

◆ IsEmpty()

def FoxitPDFSDKPython3.TaggedPDF.IsEmpty ( )

Check whether current object is empty or not.

When the current object is empty, that means current object is useless.

Returns
true means current object is empty, while false means not.

◆ RemoveTags()

def FoxitPDFSDKPython3.TaggedPDF.RemoveTags ( )

Remove the accessibility tag tree tree for the current PDF document.

This method releases the accessibility-side tag tree/cache associated with the document.

Returns
None.

◆ SaveFigureData()

def FoxitPDFSDKPython3.TaggedPDF.SaveFigureData ( )

Save figure data.

Returns
true means success, while false means not.

◆ SetAsDecorativeFigure()

def FoxitPDFSDKPython3.TaggedPDF.SetAsDecorativeFigure (   figure_index)

Decorate the figure.The decorative figure can not set alternate text.

The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Parameters
[in]figure_indexThe index of figure. Valid range: from 0 to (count-1). count is returned by function FoxitPDFSDKPython3.TaggedPDF.GetFigureCount .
Returns
true means decorate figure successed, while false means not.

◆ SetCallback()

def FoxitPDFSDKPython3.TaggedPDF.SetCallback (   callback)
Deprecated:
This function has been deprecated since Foxit PDF SDK 12.0. Please use function FoxitPDFSDKPython3.TaggedPDF.StartTagDocument instead, which receives the report callbacks (report stream and localized report text) directly as parameters.

If this function is not called, that means no callback will be used.

Parameters
[in]callbackA TaggedPDFCallback object which is implemented by user. User can change some information/data during tagged PDF document by this callback. Please ensure that the callback object keeps valid until the life-cycle of current tagged PDF object ends.
If this is null, that means to use default information/data.
Returns
None.

◆ SetCurrentFigureDataInfo()

def FoxitPDFSDKPython3.TaggedPDF.SetCurrentFigureDataInfo (   is_decorative,
  alternate_text 
)

Set current figure data info.

Parameters
[in]is_decorativeWhether the figure is decorative.
[in]alternate_textThe alternate text.
Returns
None.

◆ SetFigureAlternateText()

def FoxitPDFSDKPython3.TaggedPDF.SetFigureAlternateText (   figure_index,
  alternate_text 
)

Set figure alternate text.

The alternate text is the human-readable text, the PDF documents can be enhanced by providing alternate text for images, formulas, or other items that do not translate naturally into text. The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Parameters
[in]figure_indexThe index of figure. Valid range: from 0 to (count-1). count is returned by function FoxitPDFSDKPython3.TaggedPDF.GetFigureCount .
[in]alternate_textThe alternative descriptions text.
Returns
None.

◆ StartTagDocument()

def FoxitPDFSDKPython3.TaggedPDF.StartTagDocument (   pause,
  report_callback,
  callback 
)

Start to auto tag the given PDF document with specified tagged settings.

If user wants to get specific tag results during the tagging document process, please pass a valid report_callback and/or callback parameter to this function.

Parameters
[in]pausePause object which decides if the auto tagging process needs to be paused. This can be null which means not to pause during the tagging process. If this is not null, it should be a valid pause object implemented by user. Default value: null.
[in]report_callbackA FoxitPDFSDKPython3.StreamCallback object used to receive the generated auto tag report stream. This can be null which means not to output the report. If this is not null, it should be a valid stream callback object implemented by user. Default value: null.
[in]callbackAn FoxitPDFSDKPython3.AutoTagProviderCallback object which is implemented by user. User can provide the localized report text during tagged PDF document by this callback. Please ensure that the callback object keeps valid until the life-cycle of current tagged PDF object ends.
If this is null, that means to use default report text.
Returns
A progressive object. Please check the rate of current progress by function FoxitPDFSDKPython3.Progressive.GetRateOfProgress . If the rate is not 100 yet, call function FoxitPDFSDKPython3.Progressive.Continue to continue the progress until the progress is finished.

◆ TagFormFields()

def FoxitPDFSDKPython3.TaggedPDF.TagFormFields ( )

Tag form fields in the current PDF document.

The function is only used for a tagged PDF document. Please call function FoxitPDFSDKPython3.PDFDoc.IsTaggedPDF to check current PDF document whether is a tagged PDF document.

Returns
true means form fields tagged successfully, while false means not.